iT邦幫忙

2025 iThome 鐵人賽

DAY 18
0
Software Development

AI 慣老闆的 AI 學習歷程 - AI 時代的軟體工程的反思系列 第 18

AI 慣老闆的 AI學習日記 Day 17 - 工程師們各自亂寫 Prompt,風格與結構大走鐘

  • 分享至 

  • xImage
  •  

https://ithelp.ithome.com.tw/upload/images/20250821/20142509l6lOUuFhxc.png

(辦公室亂成一片)
貝老闆:「為什麼每頁內容長得不一樣?首頁像電商、內頁像公文,結帳頁在做詩?」

小可:(抬起摺扇)「因為大家的 Prompt 風格自由發揮,AI 實習生被你們搞成多重人格。」

工程師 King:(皺眉)「我只說『幫我寫 Copy』,AI 竟然幫我附上三首俳句。」

AI 實習生:(單眼冒出『??』)「您說的真對這邊不應該用俳句...我將在為您改一版新的七言絕句。」

工程師 King:(皺眉)「等等!!不是....」

好威(電話那頭):「喂,先別吵。立刻建立『Prompt Cookbook』+『System Prompt』,再用 Git 收口。沒有規範,AI 就是自由靈魂。」

好威解析

  1. 先定 System Prompt(角色、輸出格式、語氣);
  2. Prompt Cookbook(常用食譜+範例+反例);
  3. Prompt Repo + Git 流程(PR Checklist、CODEOWNERS)。

概念拆解

1)Prompt Style Guide:把「語氣、欄位、格式」寫成規格

沒有規格,AI 會自動「好意加料」。Style Guide 要定三件事:語氣(例如「專業但親切,避免誇張詞」)、欄位(標題、摘要、CTA、SEO keywords 等)、格式(固定輸出 JSON 或 Markdown)。另外要列出 反例禁止項(如不要自創數據、不要加入未驗證連結)。新手不懂寫,直接把範例貼給 AI:『請完全依下述 Schema 輸出,不要多欄位。』

2)System Prompt:AI 的「職前訓練」

System Prompt 讓 AI 理解角色、責任與邊界。例如:『你是一名 B2B SaaS 文案編輯,產出固定 JSON,錯誤時回傳 error 欄位。』把 語氣、品牌字彙、錯誤處理 寫死在 System Prompt,User Prompt 只放每次的素材。這能避免不同人風格飄移,也便於回溯「到底誰改了規則」。

3)Prompt Cookbook:共用的「菜單與食譜」

把常見任務寫成「食譜檔案」:目的、輸入、輸出、範例、禁忌、測試樣本。小可把首頁、部落格、產品頁的文案需求各寫一份,工程師 King 只需把資料塞進指定欄位。AI 實習生出錯時,也能用 Cookbook 的 反例 快速定位偏差,避免每次都從零聊天。

4)Prompt Repo+Git 流程:把 Prompt 當程式碼管

建立 prompts/ 目錄、分支保護、PR 模板、CODEOWNERS。任何改動都要過 PR,並附 輸出對照截圖驗收案例。這樣就能追蹤「哪次改了 System Prompt 導致語氣跑偏」。若要跨語系,開 locales/ 子目錄,搭配 Schema 校驗,避免欄位遺漏。

Takeaways

  • 一句話 Prompt 不夠用,要『規格化』。 先寫好 Style Guide 與 JSON Schema,把欄位、語氣、錯誤處理固定,AI 只填空格。對新手:直接問 AI『請幫我把下面需求轉成 Style Guide 與 Schema』,再一起微調。
  • System Prompt 穩定團隊輸出。 把品牌語氣、禁用詞、品質準則寫入 System Prompt,User Prompt 只放變動資料;這能讓不同工程師產出仍然一致。新手可用:『請用下列 System Prompt 對我的內容做一致化』。
  • Prompt 當程式碼管,問題可追溯。 用 Git + PR Checklist + CODEOWNERS,任何風格變動必須過審;CI 內可加入 Schema 驗證與快照測試(Snapshot),避免「昨天好好的今天壞掉」。

小可的落地作法

System Prompt 範本(片段)

  • 角色:B2B SaaS 文案編輯。
  • 語氣:專業、親切、避免誇大;用台灣用語。
  • 輸出:必為單一 JSON,符合 copy.v1.json Schema。
  • 錯誤:若資料不足,輸出 {"error": {"reason": "missing_fields", "fields": [..]}}

User Prompt 片段

產品:Coachly。受眾:ICF 教練。目標:誘導試用。語言:zh-TW。請輸出 copy.v1.json

精煉重點

精煉重點 1:沒有 Style Guide 的 Prompt,就像沒有菜單的廚房——每道菜都驚喜,但老闆先休克。
精煉重點 2:把 Prompt 當規格寫、用 Git 管版控,AI 才能穩定交付。

今日提問

1)你們團隊現在的 Prompt 是自由發揮還是有 Style Guide?最常出現的「走鐘」是什麼?
2)選一個頁面(如首頁 Hero 區),把欄位列成 JSON Schema,請 AI 幫你生出 3 個範例並自評理由。

小作業 Prompt

「請依下列品牌語氣與 copy.v1.json Schema,針對『產品頁 CTA』產生三版文案,並以 rationale 說明各版適用情境。」


附錄|Prompt Repo 檔案骨架與範例

repo/
  prompts/
    system/
      brand.style.md
      copy.system.md
    cookbook/
      homepage.copy.md
      blog.copy.md
      product.copy.md
    schemas/
      copy.v1.schema.json
  locales/
    zh-TW/
    en-US/
  .github/
    PULL_REQUEST_TEMPLATE.md
    CODEOWNERS

copy.v1.schema.json(精簡版)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://example.com/schemas/copy.v1.schema.json",
  "title": "Marketing Copy v1",
  "type": "object",
  "required": ["locale", "page", "section", "title", "body", "cta"],
  "properties": {
    "locale": {"type": "string", "enum": ["zh-TW", "en-US"]},
    "page": {"type": "string"},
    "section": {"type": "string"},
    "title": {"type": "string", "minLength": 4, "maxLength": 60},
    "subtitle": {"type": "string"},
    "body": {"type": "string"},
    "seo_keywords": {"type": "array", "items": {"type": "string"}},
    "cta": {
      "type": "object",
      "required": ["text", "url"],
      "properties": {
        "text": {"type": "string"},
        "url": {"type": "string", "format": "uri"}
      }
    },
    "rationale": {"type": "string"},
    "updated_at": {"type": "string", "format": "date-time"}
  },
  "additionalProperties": false
}

PR Checklist(擷取)

  • [ ] 產出符合 copy.v1.schema.json(有跑 Schema 驗證)。
  • [ ] 附三組輸入 → 輸出快照(含差異說明)。
  • [ ] 多語系是否齊全?缺漏已標注 TODO
  • [ ] 語氣與禁用詞自我審查通過。
  • [ ] 風格變更(破壞性)已有公告與版本號。

CODEOWNERS(範例)

# System Prompt 與 Style Guide 需雙簽
/prompts/system/ @xiaoke @howie

# Cookbook 文檔
/prompts/cookbook/ @king @xiaoke

# Schema 需後端審
/prompts/schemas/ @king

上一篇
AI 慣老闆的 AI學習日記 Day 16 - 團隊擴編多人同改 Replit 專案「誰又把我的改動覆蓋了?」
下一篇
AI 慣老闆的 AI學習日記 Day 18 - 知識散落,大家重覆問 AI:一個 AI 各自解讀
系列文
AI 慣老闆的 AI 學習歷程 - AI 時代的軟體工程的反思32
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言